home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / msk31doc.arc / MSKERM.HLP < prev    next >
Text File  |  1991-03-26  |  54KB  |  1,249 lines

  1.                                 MS-DOS KERMIT
  2.        FOR THE IBM PC FAMILY, COMPATIBLES, AND OTHER MS-DOS COMPUTERS
  3.  
  4.                            Version 3.10, March 1991
  5.  
  6.                                   HELP FILE
  7.  
  8. This file contains a brief summary of the commands and features of MS-DOS
  9. Kermit 3.10.  For detailed information, tutorials, installation and cabling
  10. hints, troubleshooting procedures, examples, diagrams, and advanced features
  11. of this Kermit program, consult "Using MS-DOS Kermit", by Christine M.
  12. Gianone, published by Digital Press, Bedford, MA, 1990, order number
  13. EY-C204E-DP (a second edition describing version 3.10 is in preparation).  The
  14. book includes a 5.25-inch MS-DOS Kermit 3.01 diskette.  To order, call
  15. 1-800-343-8321 (USA, toll free).  It is also available from Kermit
  16. Distribution at Columbia University and wherever computer books are sold.
  17.  
  18. MS-DOS Kermit 3.10 is a product of Kermit Distribution, Columbia University
  19. Center for Computing Activities.  The principal author of the program is
  20. Professor Joe R. Doupnik of Utah State University, with assistance from many
  21. other volunteer programmers all over the world.  This software is copyright
  22. 1982, 1991 by the Trustees of Columbia University in the City of New York.  It
  23. may be reproduced and shared without restriction except that it may not be
  24. licensed, nor sold for profit as a software product.  Kermit software is
  25. written by volunteer programmers as a public service, and is furnished without
  26. warranty of any kind.  Neither Columbia University, nor the individual
  27. authors, nor any institution or individual that has contributed to the
  28. development and documentation warrant the software in any way.
  29.  
  30. All Kermit programs on a variety of magnetic media, as well as documentation
  31. and other information, can be obtained from:
  32.  
  33.     Kermit Distribution
  34.     Columbia University Center for Computing Activities
  35.     612 West 115th Street
  36.     New York, NY  10025  USA
  37.     Telephone: (212) 854-3703
  38.  
  39. OVERVIEW
  40.  
  41. MS-DOS Kermit is a communication software program with two primary functions:
  42. terminal emulation and file transfer.  In order to communicate at all, your PC
  43. must have a communication device (serial port, internal modem, or network
  44. interface) which is connected to a modem, the phone system, or a network.
  45.  
  46. Then Kermit must be told what communication device to use.  In the most common
  47. case, this is a serial port, perhaps with an external modem attached.  If
  48. Kermit is using a serial port and/or modem, it must be told which port (SET
  49. PORT 1, SET PORT 2, etc), what the communication speed is (SET SPEED), and
  50. depending on the type of connection and the type of host, possibly many other
  51. communication parameters as well (SET DUPLEX, SET PARITY, SET FLOW-CONTROL,
  52. and so on).  For networks, it must be told which kind of network interface
  53. and/or protocol to use (SET PORT NETBIOS, SET PORT NOVELL, SET PORT DECNET,
  54. SET PORT 3COM, etc).
  55.  
  56. For terminal emulation, you must tell Kermit which kind of terminal to emulate
  57. (SET TERMINAL).  Kermit emulates the DEC VT320 terminal by default (i.e.
  58. unless you tell it otherwise).
  59.  
  60. Once you have set all the appropriate communication parameters, you can begin
  61. terminal emulation by giving the CONNECT command.  If you have an autodial
  62. modem, you must type the modem's dialing commands to establish the connection
  63. to the other computer.  You can return to Kermit by typing the "escape
  64. sequence", Ctrl-] followed by the letter C (or you can use Alt-X on IBM
  65. keyboards).
  66.  
  67. To transfer files, you must CONNECT to the other computer, login there,
  68. start up a Kermit program, tell it to SEND or RECEIVE, escape back to MS-DOS
  69. Kermit, and tell it to RECEIVE or SEND (the opposite of what you told the
  70. other Kermit).  Or you can put the remote Kermit in "server mode" by giving it
  71. the SERVER command, and then escape back to MS-DOS Kermit and give SEND and
  72. GET commands.
  73.  
  74. Here's an example, which uses a Hayes modem for dialing, and a Kermit server
  75. on the remote computer.  "C>" is the DOS prompt, "MS-Kermit>" is the MS-DOS
  76. Kermit program prompt, "$" is the remote host prompt.  All commands except
  77. Alt-X are terminated by pressing the Enter key.  Alt-X means hold down the Alt
  78. key and press the X key.  Don't type the comments on the right.
  79.  
  80.   C>kermit                        Start the MS-DOS Kermit program
  81.   MS-Kermit>set port 1            Use port COM1 (this is the default)
  82.   MS-Kermit>set speed 2400        Transmission speed is 2400 bits per second
  83.   MS-Kermit>set terminal vt102    Select terminal type
  84.   MS-Kermit>connect               Begin terminal emulation
  85.   ATDT5551234                     Type Hayes dialing command
  86.   CONNECT 2400                    Hayes responds when call is completed
  87.   Welcome to ...                  Press Enter, see remote computer's greeting
  88.   Username: xxx                   Log in to remote computer
  89.   Password: yyy                   Type your password (probably won't echo)
  90.   $                               Remote computer's prompt
  91.   $ kermit                        Run Kermit on remote computer
  92.   C-Kermit>                       Remote Kermit's prompt
  93.   C-Kermit>server                 Put remote Kermit in server mode
  94.   Alt-X                           Escape back to MS-DOS Kermit
  95.   MS-Kermit>send oofa.txt         Send a file to the remote computer
  96.   MS-Kermit>get foo.bar           Get a file from the remote computer
  97.   MS-Kermit>bye                   All done, terminate your session
  98.   C>                              Back at DOS prompt
  99.  
  100. MS-DOS KERMIT PROGRAM INVOCATION
  101.  
  102. MS-DOS Kermit can be run interactively, from a batch file, as an "external"
  103. DOS command, or with redirected or piped standard input and output.  When
  104. MS-DOS Kermit starts, it executes any commands found in its initialization,
  105. MSKERMIT.INI, in the current disk or DOS path, or the file specified by "-f
  106. filename" on the Kermit command line.
  107.  
  108. The binary, executable IBM PC Kermit program that is included on the official
  109. MS-DOS Kermit distribution diskette (obtained from "Using MS-DOS Kermit" or
  110. from Columbia University) can have corrections, or "patches", applied to it in
  111. case bugs are discovered in the program after it was released.  These patches
  112. can only be applied to the binary program as distributed, and not to any other
  113. version.  Patches are distributed in the form of a short text file called
  114. MSKERMIT.PCH, which you can obtain from Columbia University.  This file should
  115. be stored in the same disk and directory as your MSKERMIT.INI file.  To apply
  116. the patches, add a line that says "patch" to your MSKERMIT.INI file.  If there
  117. is anything wrong with the file, or if it does not agree in any way with your
  118. Kermit version, the patches are not applied.  Obtain legitimate patch files
  119. only from Columbia University.
  120.  
  121. * Interactive Operation:
  122.  
  123. To run MS-DOS Kermit interactively, invoke the program from DOS command level
  124. by typing its name, usually "kermit".  When you see the command's prompt,
  125. "MS-Kermit>", you may type Kermit commands repeatedly until you are ready to
  126. exit the program.  The commands EXIT or QUIT return you to DOS.
  127.  
  128. While typing commands, use the Backspace key to erase the character most
  129. recently typed, Ctrl-W to delete the most recent field, or Ctrl-U to delete
  130. the entire command, and enter the command by pressing the Enter key or Ctrl-L.
  131. A question marked typed at any point in a command (except in a filename or
  132. character string) will give you a brief hint about what's expected at that
  133. point.  Pushing the Esc key will complete the command current field, if
  134. possible, and position the cursor at the next field.  If completion is not
  135. possible, Kermit will beep.  You can cancel any command during its execution
  136. by typing Ctrl-C.  Use question mark (?) to "feel" your way through commands
  137. and find out what the options are.
  138.  
  139. * Command Line Invocation:
  140.  
  141. MS-DOS Kermit may be invoked with command line arguments from DOS command
  142. level, for instance:
  143.  
  144.   A>kermit set port 1, set speed 9600, connect
  145.  
  146. In this case, help and completion are not available and MS-DOS Kermit will
  147. exit back to DOS after completing the specified commands unless you include
  148. the STAY command.  Several commands may be given on the command line,
  149. separated by commas.
  150.  
  151. * Batch Operation:
  152.  
  153. Like other MS-DOS programs, MS-DOS Kermit may be operated under batch with
  154. command line arguments.  If your batch program invokes Kermit without command
  155. line arguments it will run interactively, reading commands from the keyboard
  156. and not the batch file.  When it exits, batch processing will continue to the
  157. end of the batch file.  An ERRLEVEL number is returned by Kermit to assist
  158. batch file controls (0 = success, nonzero = at least one file transfer failed).
  159.  
  160. * DOS Environment for MS-DOS Kermit:
  161.  
  162. Make sure your DOS PATH variable (as set by the PATH= line in your
  163. AUTOEXEC.BAT file) includes the disk and directory where the Kermit program
  164. and the MSKERMIT.INI file are kept.
  165.  
  166. Kermit searches for a DOS environment variable named KERMIT, and configures
  167. itself accordingly.  You can this variable by putting a line like this in your
  168. AUTOEXEC.BAT file:
  169.  
  170.   SET KERMIT=command;command;...
  171.  
  172. The commands can be:
  173.  
  174.   INPUT-BUFFER <length> - Length of buffer for INPUT command, 128 by default.
  175.   ROLLBACK <number> - Number of screens for rollback (PgUp), 10 by default.
  176.   COM1 <address> or COM1 <address> <irq> - Address (and optionally IRQ) of COM1
  177.   (Use with caution! See description of SET COMn command).
  178.   COM2, COM3, COM4 - Same as COM1, but for COM2-4.
  179.  
  180. Example:
  181.  
  182.   SET KERMIT=INPUT-BUFFER 1000;ROLLBACK 100
  183.  
  184. Kermit also looks in the DOS environment for COMSPEC and SHELL, and uses the
  185. program denoted by SHELL= (if found, otherwise by COMSPEC=) when executing
  186. the PUSH, RUN, TYPE, and similar commands.
  187.  
  188. Kermit is capable of having many files open at once (several TAKE files, a
  189. file which is being transferred, up to three log files, etc).  You should
  190. make sure the FILES= line in CONFIG.SYS allows for at least 20 open files.
  191. You should also have a BUFFERS= value of about 20 in CONFIG.SYS.
  192.  
  193. * MS-DOS Kermit in Non-DOS Environments:
  194.  
  195. MS-DOS Kermit can run under OS/2 in the "DOS box", provided you first
  196. issue the command SETCOM40 COM1=ON.
  197.  
  198. MS-DOS Kermit can run under Microsoft Windows 2.03 and Windows 386 2.03 as
  199. a regular MS-Windows application (icon, mouse, cut-&-paste, etc), as well as
  200. with Windows 3.0.  Files can be transferred while other applications are
  201. active, as long as Kermit has a piece of the screen (has not shrunk to an
  202. icon).  Use PIFEDIT to make a .PIF file for Kermit, and it will run as a
  203. regular Windows application.  Otherwise it takes over the whole screen.
  204.  
  205. For MS-Windows 2.0, use PIFEDIT to set up Kermit like this:
  206.  
  207. Program name:           KERMIT.EXE or whatever is the name of the Kermit file.
  208. Program title:          MS-DOS Kermit 3.1
  209. Program parameters:     Leave blank since this becomes a command line
  210. Initial directory:      Directory, if any, to CD to when starting Kermit
  211. Memory Requirements:    190 KB Required, 400 KB Desired (see below)
  212. Directly Modifies:      Clear all boxes (pretend Kermit is very good)
  213. Program Switch:         Check the Text box
  214. Screen Exchange:        Check the Graphics/Text box
  215. Close Window on exit:   Check the box
  216.  
  217. Although Kermit does direct writes to the screen it does so in a "TopView
  218. aware" manner.   One may check or leave empty the COM1 or COM2 boxes even
  219. though Kermit does directly modify the serial port.  Kermit will block (XOFF)
  220. if left running as an icon, but it will run smoothly while sharing the screen
  221. with other tasks.  Communications throughput is limited by Windows' character
  222. drawing speed.  Graphics are done as if you had a monochrome adapter.  Screen
  223. dumps ( ^] F or Control End) will be of Kermit's underlying full screen.  In
  224. summary, tell Windows that Kermit is exceptionally well behaved.
  225.  
  226. If you check the "modifies memory" box or some of the other boxes (or if you
  227. don't have a KERMIT.PIF file at all), then Kermit will take over the whole
  228. screen and Windows will become inactive, and Windows features will no longer
  229. work.  But Kermit will run much faster, and graphics will work normally.
  230.  
  231. If Windows complains that it does not have enough memory to run Kermit,
  232. then you can reduce Kermit's memory requirements by allocating less memory for
  233. rollback screens.  Kermit's default number of rollback screens is 10, and each
  234. rollback screen takes about 8K of memory (more or less depending on the type
  235. of display adapter you have).  With the default 10 rollback screens, Kermit
  236. needs about 175K of memory.  You can reduce this to about 100K by getting rid
  237. of some or all of your rollback screens; if you put a line like SET
  238. KERMIT=ROLLBACK 5 in your AUTOEXEC.BAT file, this tells Kermit how many
  239. screens to get memory for.  If you specify 0, this will reduce Kermit's memory
  240. requirements by about 80K.
  241.  
  242. Microsoft Windows 3.0 KERMIT.PIF suggestions for MS-DOS Kermit v3.10;
  243. "X" means check this box, "o" means leave this box or button empty:
  244.  
  245. Program Filename:       KERMIT.EXE
  246. Window Title:           MS-DOS Kermit 3.1
  247. Optional Parameters:
  248. Startup Directory:      C:\KERMIT            <-- use your directory
  249. Memory Reuirements:     KB Required  190     KB Desired  400
  250. Display Usage:          o Full Screen        Execution o Background
  251.                         X Windowed                     o Exclusive
  252.   X Close Window on Exit
  253. (Note: if EGA/VGA graphics are employed then use the Full Screen option.
  254. More KB Desired yields greater text screen rollback memory.)
  255.  
  256.                        Advanced Options
  257. Multitasking Options:
  258.         Background Priority  50         Foreground Priority  100
  259.       X Detect Idle Time
  260.  
  261. Memory Options:
  262.  EMS Memory     KB Required  0          KB Limit 1024      o Locked
  263.  XMS Memory     KB Required  0          KB Limit 1024      o Locked
  264.              o  Uses High Memory      o Locked Application Memory
  265. (Note: MS-DOS Kermit uses neither EMS nor XMS memory)
  266.  
  267. Display Options:
  268.  Video Memory:          o Text   o Low Graphics   X High Graphics
  269.  Monitor Ports:         o Text   o Low Graphics   X High Graphics
  270.         X Emulate Text Mode             X Retain Video Memory
  271. Other Options:
  272.         X Allow Fast Paste              o Allow Close When Active
  273. Application Shortcut Key:  NONE
  274. (Note: MS-DOS Kermit uses all of graphics memory to save images.)
  275.  
  276. Hints for creating a DESQview .DVP configuration file for MS-DOS Kermit 3.1:
  277.  
  278.  ============================================================================
  279.                         Change a Program
  280.  Program Name............: MS-DOS Kermit v3.1
  281.  Keys to Use on Open Menu: KE                   Memory Size (in K): 200
  282.                                                 (say 160 minimum)
  283.  ----------------------------------------------------------------------------
  284.  Program...: KERMIT.EXE
  285.  Parameters:            (Kermit command line items, if any, go here.)
  286.  Directory.: C:\yourdir
  287.  ----------------------------------------------------------------------------
  288.  Options:
  289.                 Writes text directly to screen.......: [N]      *
  290.                 Displays graphics information........: [N]      **
  291.                 Virtualize text/graphics (Y,N,T).....: [T]      ***
  292.                 Uses serial ports (Y,N,1,2)..........: [Y]
  293.                 Requires floppy diskette.............: [N]
  294.  
  295.    *   Not true, but MS-DOS Kermit is DESQview-aware and covers up nicely.
  296.    **  Not true, naturally, but causes DESQview to put Kermit into full
  297.        screen mode while graphics are executed and then to return to windowed
  298.        mode after switching to text terminal emulation.
  299.    *** Can be [Y] with the same effect as above.
  300.  ----------------------------------------------------------------------------
  301.                         Change a Program Advanced Options
  302.  
  303.  System Memory (in K).....:     0  Maximum Program Memory Size (in K)..:
  304.  Script Buffer Size.......:     0  Maximum Expanded Memory Size (in K) :
  305.  Text Pages: 1  Graphics pages: 0  Initial Mode:  3    Interrupts: 00 to FF
  306.  
  307.  Window Position:
  308.         Maximum Height:  25     Starting Height:  20    Starting Row...:  5
  309.         Maximum Width.:  80     Starting Width.:  40    Starting Column:  5
  310.   (Choose your own window sizes, naturally. 132 column mode causes DESQview
  311.    to switch to full screen.)
  312.  ----------------------------------------------------------------------------
  313.                                 Shared Program
  314.  Pathname..:
  315.  Data......:
  316.  ----------------------------------------------------------------------------
  317.  Close on exit (Y,N,blank)......: [ ]   Uses its own colors..............: [N]
  318.  Allow Close Window command.....: [Y]   Runs in background (Y,N,blank)...: [Y]
  319.  Uses math coprocessor..........: [N]   Keyboard conflict (0-F)..........: [0]
  320.  Share CPU when foreground......: [Y]   Share EGA when foreground/zoomed.: [Y]
  321.  Can be swapped out (Y,N,blank).: [ ]   Protection level (0-3)...........: [3]
  322.  ============================================================================
  323.  
  324.  
  325. SUMMARY OF MS-DOS KERMIT COMMANDS
  326.  
  327. The commands listed are for the IBM PC, PS/2, and compatibles.  Other versions
  328. of MS-DOS Kermit (DEC Rainbow, NEC PC, Victor 9000, etc) lack certain commands
  329. and features described here, primarily those having to do with terminal
  330. emulation and character set translation.
  331.  
  332. Kermit commands consist of a sequence of "words" (verbs, nouns, numbers,
  333. filenames) separated by spaces and terminated by carriage return (Enter).
  334. In descriptions of Kermit's commands, the following notation is used:
  335.  
  336.   <parameter>   - Replace this with an actual number, or filename, etc.
  337.   <number>      - Replace with an actual decimal number
  338.   <filename>    - A file specification, which may include disk & directory
  339.   <hh:mm:ss>    - Time of day in 24-hour notation, less than 12 hours from now
  340.   [<parameter>] - An optional field, which may be omitted
  341.   {A,B,C}       - Choose one of the items listed
  342.   [{A,B,C}]     - Optionally choose one of the items listed
  343.   = <value>     - Shows default value
  344.  
  345. * Special Characters:
  346.  
  347. The following characters perform special functions in MS-DOS Kermit commands:
  348.  
  349. Space      Separates command words ("fields").
  350. TAB        (Ctrl-I) Like space
  351. ESC        (Ctrl-[) Completes a keyword if possible.
  352. Enter      (Ctrl-M, Carriage Return) Enters a command.
  353. Formfeed   (Ctrl-L) Like Enter, but clears the screen first.
  354. Linefeed   (Ctrl-J) Like Enter.
  355. Backspace  (Ctrl-H, Del) Deletes rightmost character from the command.
  356. Ctrl-W     Deletes rightmost word from the command.
  357. Ctrl-U     Deletes the entire command.
  358. Ctrl-C     Cancels the current command, even if you have already entered it.
  359. ?          (Question Mark) Requests a menu for the current command field.
  360. ;          (Semicolon) Introduces a trailing command (in command files only).
  361. \          (Backslash) Introduces a "backslash code".
  362. ,          (Comma) Separates commands in a macro definition.
  363. { }        (Braces) used for grouping characters or words together.
  364.  
  365. * Backslash Codes:
  366.  
  367. Backslash codes are available to enter special characters into Kermit
  368. commands, and for other purposes too.  For example, if you want to use the
  369. OUTPUT command to send a Ctrl-C to the host, you can't put the Ctrl-C
  370. literally in the command, because typing Ctrl-C would cancel the command.
  371. Instead, you can put a backslash followed by digits to denote the ASCII value
  372. of the Ctrl-C character (which is 3): "output \3".  Similarly for Carriage
  373. Return: "output login myname\13".
  374.  
  375. \123    (up to 3 decimal digits) - A decimal number or character value
  376. \d123   (up to 3 decimal digits) - Same as 123
  377. \o123   (up to 3 octal digits) - An octal (base 8) number or char value
  378. \x123   (up to 3 hexadecimal digits) - a hexadecimal (base 16) number or char
  379. \{ }    For grouping, e.g. \{12}6 = Ctrl-L 6, not ~
  380. \;      Include a semicolon in a TAKE-file command or macro definition.
  381.  
  382. Other backslash codes:
  383.  
  384. \%      Introduce a Kermit variable, \%1, \%2, ..., \%a, \%b, ... \%z
  385. \K      (or \k) Introduce a Kermit connect-mode verb like \Kexit
  386. {\K}    A user-defined macro assigned to a key
  387. \B      (or \b) Send a BREAK (OUTPUT command only)
  388. \255    Shorthand for CRLF or LFCR   (INPUT command only)
  389. \CD     Carrier Detect RS-232 signal (WAIT command only)
  390. \DSR    Data Set Ready RS-232 signal (WAIT command only)
  391. \CTS    Clear to Send RS-232 signal  (WAIT command only)
  392. \v      Introduce a built-in variable like \v(date).
  393.  
  394. * Program Management Commands:
  395.  
  396. EXIT or QUIT
  397.   Exit from MS-DOS Kermit.  Close all logs and files.  Leave serial port
  398.   and modem connections open.  Close most kinds of network connections.
  399.   Execute ON_EXIT macro if one is defined.
  400.  
  401. TAKE <filename>
  402.   Execute commands from the specified file instead of the keyboard.
  403.  
  404. PUSH
  405.   Go to DOS prompt.  Return to Kermit prompt by typing the DOS EXIT command.
  406.  
  407. RUN <command>
  408.   Run any DOS program or execute any DOS command, e.g. RUN EDLIN AUTOEXEC.BAT.
  409.  
  410. VERSION
  411.   Display MS-DOS Kermit program version number and date.
  412.  
  413. ECHO <text>
  414.   Display the <text> on the screen.  For issuing messages from TAKE files.
  415.  
  416. SET PROMPT <text>
  417.   Change the program prompt from MS-Kermit> to the specified text.
  418.  
  419. COMMENT <text>
  420.   For adding comments to a TAKE file.
  421.  
  422. <command> ; text
  423.   Commands in TAKE files can have trailing comments preceded by semicolon (;).
  424.  
  425. <text>-
  426. <text>
  427.   Commands in TAKE files or macro definitions can be continued with hyphens,
  428.   but not in a trailing comment.
  429.  
  430. * DOS-like Commands:
  431.  
  432. CD [<path>]
  433.   Like DOS CD command, but drive letter may also be included.
  434.  
  435. CLS
  436.   Clear the PC's screen.
  437.  
  438. DELETE <filespec>
  439.   Deletes specified file(s).
  440.  
  441. DIRECTORY [<filespec>]
  442.   Like DOS DIR command.
  443.  
  444. TYPE <filename>
  445.   Like DOS TYPE command.
  446.  
  447. SPACE [<disk-letter>]
  448.   Shows free space on current or specified disk.
  449.  
  450. SHOW MEMORY
  451.   Shows free memory.
  452.  
  453. * Commands for Getting Information:
  454.  
  455. HELP
  456.   Displays a brief help message about MS-DOS Kermit.
  457.  
  458. SHOW <category>
  459.   Displays current settings, definitions, statistics selectively
  460.   (type SHOW ? for a list of categories that can be shown).
  461.  
  462. STATUS
  463.   Shows values of most SET parameters.
  464.  
  465. VERSION
  466.   Display the program version number.
  467.  
  468. * Commands for Setting Communication Parameters
  469.  
  470. SET COM1 <address> [ <irq> ]
  471.   Tell Kermit that the hardware address of COM1, which must be a 8250 or
  472.   compatible UART, is <address> and, optionally, that its interrupt request
  473.   line number is <irq>.  Also SET COM2, SET COM3, SET COM4.  Used to configure
  474.   Kermit for nonstandard communication boards.  If IRQ not specified, Kermit
  475.   tries 3 and 4 (standard IRQs for communication ports).  USE WITH EXTREME
  476.   CAUTION: specification of incorrect address or IRQ number could harm your PC
  477.   or files.
  478.  
  479. SET PORT {COM1, COM2, COM3, COM4} = COM1
  480.   Select communication device (SET PORT ? for list of available devices,
  481.   see below for local area nets).  You can also say SET PORT 1, SET PORT 2,
  482.   etc.  Port must be real 8250 or 16550A UART.  If it isn't, Kermit will use
  483.   BIOS rather than direct hardware control.
  484.  
  485. SET PORT {BIOS1, BIOS2, BIOS3, BIOS4}
  486.   Use BIOS-level driver for COM1, COM2, COM3, or COM4, etc, rather than its
  487.   own built-in code.  Allows Kermit to be used with LANs, nonstandard devices,
  488.   etc.
  489.  
  490. SET PORT <other> - See section on Local Area Networks.
  491.  
  492. SET SPEED <number>
  493.   Communications port line speed: 1200, 2400, 9600, etc.  SET SPEED ? for list.
  494.   75/1200 is "split speed" (75 out, 1200 in).  Applies to currently selected
  495.   serial port.
  496.  
  497. SET PARITY {EVEN, ODD, MARK, SPACE, NONE} = NONE
  498.   Character parity to use during communication.  If not NONE, then 8th-bit
  499.   quoting is used during file transfer.
  500.  
  501. SET DISPLAY { 7, 8 } = 7
  502.   Synonym for SET TERMINAL BYTESIZE { 7, 8 }
  503.  
  504. SET DUPLEX {FULL, HALF} = FULL
  505.   Select full or half duplex communication.
  506.   FULL = remote echo.  HALF = local echo plus RTS/CTS hardware handshake.
  507.  
  508. SET HANDSHAKE {NONE, XON, CR, LF, CODE <ascii-value>} = NONE
  509.   Half-duplex line turnaround character (XON is most common).
  510.  
  511. SET FLOW-CONTROL {XON/XOFF, RTS/CTS, NONE} = XON/XOFF
  512.   Select full-duplex flow control method.
  513.  
  514. * Commands for Connecting to a Remote Host
  515.  
  516. CONNECT
  517.   Make a terminal connection to a device or another computer on the currently
  518.   selected port using the current communication settings.  Use Alt-X to return
  519.   ("escape back") to the MS-Kermit> prompt (hold down the Alt key and press
  520.   x), Raises DTR.  Can abbreviate as C.
  521.  
  522. HANGUP
  523.   Hang up a dialed modem connection by lowering DTR.
  524.  
  525. SET DEBUG SESSION
  526.   Turn off terminal emulator, display received characters literally for
  527.   debugging: ^X = Ctrl-X, ~X = X with 8th bit on.
  528.  
  529. SET DEBUG OFF
  530.   Turn off session debugging.
  531.  
  532. There is no built-in DIAL command.  Connect to the modem and dial it by hand
  533. (for example ATDT<number> for a Hayes modem), or use a macro or script program
  534. to do the dialing.
  535.  
  536. * Commands for Controlling Terminal Emulation
  537.  
  538. SET TERMINAL [ TYPE ] {VT320, VT100, VT102, VT52, HEATH-19, TEK4010} = VT320
  539.   Select type of terminal to emulate.  More types may be available, type
  540.   SET TERMINAL TYPE ? for a list.
  541.  
  542. SET TERMINAL ARROW-KEYS { APPLICATION, CURSOR }
  543.   Explicitly puts the arrow keys (actuall, the Kermit verbs associated with
  544.   them) in application or cursor mode.
  545.  
  546. SET TERMINAL BELL { AUDIBLE, VISUAL, NONE } = AUDIBLE.
  547.   What to do with arriving BEL (beep, Ctrl-G) characters.
  548.  
  549. SET TERMINAL BYTESIZE { 7, 8 }
  550.   Use 7 for stripping off parity bit, e.g. with UNIX systems, during terminal
  551.   emulation.  Use 8 for 8-bit international character sets.
  552.  
  553. SET TERMINAL CHARACTER-SET { LATIN1, DEC-MCS, GERMAN, FRENCH, etc } = LATIN1
  554.   Tell Kermit what character set is used by the host computer during terminal
  555.   emulation.  Received characters are translated from this set into the
  556.   current PC code page.  Characters that you type are translated from current
  557.   PC code page to this set.  LATIN1 is ISO Latin Alphabet 1 (an 8-bit set).
  558.   GERMAN, FRENCH, etc, are 7-bit National Replacement Character sets (NRCs).
  559.   Use SET KEY and SET TRANSLATION INPUT to override Kermit's built-in
  560.   character translations on an individual basis, and SET TERMINAL
  561.   CHARACTER-SET TRANSPARENT to disable them altogether.  Optional trailing
  562.   parameters G0, G1, G2, and G3 can be used to designate the specified
  563.   character set into the given Gn's.  Example: SET TERM CHAR LATIN1 G1.
  564.  
  565. SET TERMINAL CLEAR-SCREEN
  566.   Clears the screen and screen memory.
  567.  
  568. SET TERMINAL COLOR <number> [, <number> [, <number> ] ]
  569.   Set foreground and background color during terminal emulation.  The numbers
  570.   are 0 (no snow on IBM CGA), 1 (high-intensity foreground), 10 (fast screen
  571.   update on IBM EGA), 3x (foreground color), 4x (background color), where x is
  572.   the sum of any of 1 (Red), 2 (Green), and 4 (Blue).
  573.  
  574. SET TERMINAL CONTROLS {7-BIT, 8-BIT}
  575.   Tells VT320 emulator whether to send 7-bit or 8-bit control sequences when
  576.   DEC function, arrow, editing, or keypad keys are pressed.
  577.  
  578. SET TERMINAL CURSOR-STYLE {BLOCK, UNDERLINE}
  579.   Selects the cursor style for terminal emulation.
  580.   The default is underline.
  581.  
  582. SET TERMINAL DISPLAY
  583.   Synonym for SET TERMINAL BYTESIZE.
  584.  
  585. SET TERMINAL DIRECTION {LEFT-TO-RIGHT, RIGHT-TO-LEFT}
  586.   Direction of screen writing during terminal emulation.
  587.  
  588. SET TERMINAL GRAPHICS <name>
  589.   Specifies the type of graphics adapter in your PC: CGA, EGA, VGA, and others
  590.   (SET TERM GRAPH ? for complete list).  MS-DOS Kermit will automatically try
  591.   to figure out what kind of adapter you have.  Use this command if it guesses
  592.   incorrectly.
  593.  
  594. SET TERMINAL GRAPHICS CHARACTER-WRITING {OPAQUE, TRANSPARENT}
  595.   Tells whether text characters written on graphics screens should be
  596.   let graphics show through.
  597.  
  598. SET TERMINAL GRAPHICS COLOR <number> [, <number> [, <number> ] ]
  599.   Foreground and background colors for graphics screens.  Numbers same as for
  600.   SET TERMINAL COLOR.
  601.  
  602. SET TERMINAL GRAPHICS CURSOR {ON, OFF}
  603.   Tells whether there should be a text cursor during graphics terminal
  604.   emulation.  Default is ON.
  605.  
  606. SET TERMINAL KEYCLICK {ON, OFF}
  607.   On keyboards that support this, turns keyclick on or off.
  608.  
  609. SET TERMINAL KEYPAD {APPLICATION, NUMERIC}
  610.   Puts the numeric keypad into the specified mode.
  611.  
  612. SET TERMINAL MARGIN-BELL {ON, OFF}
  613.   Whether to ring the bell when the cursor passes nears the right column of
  614.   the screen.
  615.  
  616. SET TERMINAL NEWLINE {ON, OFF}
  617.   ON means to send both a carriage return and a linefeed when you press Enter.
  618.  
  619. SET TERMINAL REPLAY
  620.   Synomym for @c<REPLAY.
  621.  
  622. SET TERMINAL ROLL {ON, OFF}
  623.   ON means to restore rolled-back screens to the end when new characters
  624.   arrive.  OFF means to display new characters at the current cursor position,
  625.   even if it is in a rolled-back screen.
  626.  
  627. SET TERMINAL SCREEN-BACKGROUND {NORMAL, REVERSE}
  628.   REVERSE exchanges the foreground and background colors.
  629.  
  630. SET TERMINAL TABSTOPS {AT <n>, CLEAR AT <n>, CLEAR ALL}
  631.   Sets or clears screen tab stops at the specified positions.  <n> can be a
  632.   single number, a list of numbers, or <position>:<interval> to set tabs
  633.   beginning at the specified <position>, every <interval> spaces, e.g.
  634.   SET TAB AT 1:10.  By default, tabs are set every eight spaces.
  635.  
  636. SET TERMINAL TEK {ENABLE, DISABLE}>
  637.   Whether Kermit should automatically enter Tektronix graphics mode upon
  638.   receipt of special escape sequences from the host (see MSVIBM.TEK).
  639.   ENABLEd by default.
  640.  
  641. SET TERMINAL WIDTH {80, 132}
  642.   Tells Kermit to put the video adapter into 80-column or 132-column mode.  If
  643.   Kermit can do this itself, it will.  Otherwise it will attempt to run the
  644.   DOS batch program COLS80.BAT or COLS132.BAT to do the job.  You must supply
  645.   these files.  They should contain whatever external DOS commands you have
  646.   at your disposal to change the screen mode.
  647.  
  648. SET TERMINAL WRAP {ON, OFF}
  649.   Whether to start a new screen line when characters arrive past the right
  650.   (or left if SET TERM DIR LEFT) margin.
  651.  
  652. SET PRINTER <name>
  653.   To redirect any printing that is done during terminal emulation to a device
  654.   or file.  Default is PRN (the DOS printer device).
  655.  
  656. * Local Area Networks
  657.  
  658. SET PORT NETBIOS
  659.   Tells Kermit to use IBM Netbios rather than serial communication port.
  660.   Tells MS-DOS Kermit to await connections from other PCs on the net.
  661.   Also used with AT&T StarLAN/StarGroup.
  662.  
  663. SET PORT NETBIOS <name>
  664.   Tells Kermit to connect to another PC on the Netbios network.  Also for
  665.   AT&T StarLAN/StarGroup.
  666.  
  667. SET PORT NOVELL
  668.   For using Novell network asynchronous communication servers (NASI/NACS).
  669.   (see below).
  670.  
  671. SET PORT DECNET [<node> [<password>]]
  672.   For DECnet-DOS LAT or CTERM connections.  Specify node to connect to, LAT
  673.   password if required.
  674.  
  675. SET PORT UB-NET1
  676.   For Ungermann-Bass Net/One.
  677.  
  678. SET PORT OPENNET [<node>]
  679.   For Intel OpenNET, similar to Netbios.
  680.  
  681. SET PORT 3COM
  682.   For using 3COM BAPI asynchronous communication server, BRIDGE PCS or 3+OPEN
  683.   TCP versions.
  684.  
  685. SET PORT EBIOS { 1, 2, 3, 4 }
  686.   Use Extended BIOS for communication with EBIOS-based asynchronous
  687.   communication servers like IBM's LANACS.
  688.  
  689. SET PORT TELAPI <internet-address>
  690.   Connect to an Internet TCP/IP host through Novell LAN Workplace for DOS.
  691.  
  692. SET PORT TES <hostname>
  693.   Connect to a VAX/VMS system that is running Netware/VMS.
  694.  
  695. SET PORT { BIOS1, BIOS2, BIOS3, BIOS4 }
  696.   For using any network that operates through a BIOS-level Int 14h COM port
  697.   driver.  Examples include TCP/IP Telnet (e.g. through Interlan TCP/IP Novell
  698.   Gateway, or FTP Software TC/TCP Jan 1990 version 2.04 pl 1 or later).
  699.  
  700. SET PRINTER <filename or PRN>
  701.   Sends Connect mode printer material to the indicated file instead of to the
  702.   standard DOS printer name PRN; this is a "print to disk" option. SHOW LOG
  703.   displays the current filename (defaults to PRN).
  704.  
  705. HANGUP
  706.   Close network connection, terminate network session.
  707.  
  708. * CONNECT-Mode Escape-Level Commands:
  709.  
  710. During terminal emulation, you may type Ctrl-] (hold down Ctrl and press the
  711. rightbracket key) followed by any of the following characters:
  712.  
  713.   ?   Help -- prints the available single-character commands
  714.   0   (the digit zero) Transmit a NUL (ASCII 0)
  715.   B   Transmit a BREAK signal                                 (also Alt-B)
  716.   C   Close the connection and return to Kermit prompt level  (also Alt-X)
  717.   F   File the current text screen in the screen dump file    (also Ctrl-End)
  718.   H   Hangup the phone (or network connection)
  719.   L   Transmit a Long Break (1.8 seconds)
  720.   M   Toggle the mode line, i.e. turn it off if it is on & vice versa
  721.   P   Push to DOS; get back to CONNECT by typing EXIT at the DOS prompt
  722.   Q   Temporarily quit logging the remote session
  723.   R   Resume logging the remote session
  724.   S   Show the status of the connection
  725.   ^]  (or whatever you have set the escape character to be)
  726.       Typing the escape character twice sends one copy of it to the host
  727.  
  728. Use SET ESCAPE to change the escape character from Ctrl-Rightbracket to some
  729. other character, or you can use the Alt-key equivalents noted above on the IBM
  730. keyboard, or you can use SET KEY to assign \Kexit or other "Kermit verbs" to
  731. the keys of your choice.  \Kexit is also assigned to Alt-X on IBM keyboards.
  732.  
  733. Screen dumps are of Kermit's current screen.  If it is a text screen, it is
  734. appended to KERMIT.SCN (or whatever other filename you have given in your most
  735. recent SET DUMP command), separated from previous material by a formfeed
  736. (Ctrl-L).  Graphics screens are saved in TIFF 5.0 format to separate files
  737. named TEKPLT01.TIF, TEKPLT02.TIF, etc.  You can save graphics screens with
  738. Ctrl-End, but not Ctrl-[F.  See MSGTIF.DOC for a description of TIFF format.
  739.  
  740. * SET TRANSLATE INPUT Command:
  741.  
  742.   SET TRANSLATE ON
  743.   SET TRANSLATE INPUT <code1> <code2>
  744.  
  745. Specifies that when a character represented by <code1> arrives at the
  746. communication port during terminal emulation, it should be translated into
  747. <code2> before display on the screen.  Overrides current terminal character
  748. set translation for that character.  Translations set up in this way take
  749. effect only after you give the command SET TRANSLATE INPUT ON, and you can
  750. disable (and restore the default translations) with SET TRANSLATE INPUT OFF.
  751. SET TRANSLATE INPUT ON/OFF does not affect the built-in translation between
  752. terminal character set and PC code page.  To disable the latter, use SET
  753. TERMINAL CHARACTER-SET TRANSPARENT.
  754.  
  755. * SET KEY Command:
  756.  
  757.   SET KEY <scancode> <value>
  758.  
  759. Assigns <value> to the key whose scan code is given.  When you press the key
  760. or key combination that corresponds to the scan code during terminal
  761. emulation, the <value> is transmitted out the communication port.  If you
  762. don't know the scan code, type SET KEY alone on a line, then press the desired
  763. key or key combination when prompted, then enter the definition.  The <value>
  764. can be a single character, a text string (which may contain backslash codes),
  765. or one or more Kermit verbs.  SET KEY overrides the default translation for
  766. the given key.
  767.  
  768. * Commonly Used Kermit Keyboard Verbs (default assignment in parens):
  769.  
  770. \Kexit        Exit from connect mode (Alt-X, Ctrl-]C)
  771. \Kbreak       Send a BREAK signal (Alt-B, Ctrl-]B)
  772. \Kdos         Push to DOS (Ctrl-]P)
  773. \Kdump        Dump current screen to file (Ctrl-End)
  774. \Khangup      Hangup communication port connection (Ctrl-]H)
  775. \Klogoff      Stop session logging (Ctrl-]Q)
  776. \Klogon       Resume session logging (Ctrl-]R)
  777. \Knethold     Put network connection on hold or enter network shell
  778. \Kmodeline    Toggle mode line off/on++ (keypad minus)
  779. \Kprtscn      Print current screen (Print Screen)
  780. \Kreset       Reset terminal emulator (Alt-=)
  781. \Ktermtype    Change terminal type (Alt-minus)
  782. \Kupscn       Roll back screen (PgUp)
  783. \Kupone       Roll back screen one line (Ctrl-PgUp)
  784. \Kdnscn       Roll screen forward (PgDn)
  785. \Kdnscn       Roll screen forward one line (Ctrl-PgDn)
  786. \KterminalR   Execute macro named TERMINALR if any
  787. \KterminalS   Execute macro named TERMINALS if any
  788. \Knethold     Put a network connection on hold, select another one
  789.  
  790. Use SET KEY to assign or reassign these verbs to the keys of your choice.
  791. Example: "SET KEY \315 \Kexit" puts \Kexit on the F1 key.
  792.  
  793. SET KEY CLEAR: Restore all Kermit's default key assignments.
  794. SET KEY ON:  Use BIOS to read keystrokes (scan codes).
  795. SET KEY OFF: Use DOS rather than BIOS to read keystrokes.
  796. SET KEY LK:  Use external DEC LK250 keyboard driver (if loaded).
  797.  
  798. * Commands for Transferring Files:
  799.  
  800. Start a Kermit program on the remote computer, give it a "send", "receive",
  801. or "server" command, escape back to MS-DOS Kermit, and give it one of the
  802. following commands:
  803.  
  804. SEND <filename> [<alternate-name>]
  805.   Send files to remote Kermit receiver or server.  Can abbreviate as S.
  806.  
  807. RECEIVE [<filename>]
  808.   Wait for a file to arrive from the other Kermit program, which must
  809.   be given a SEND command.  Can abbreviate as R.
  810.  
  811. GET <remote-filename>
  812.   Ask a Kermit server to send the specified file(s).  Use GET alone on a line
  813.   to be prompted for remote and local names separately.
  814.  
  815. MAIL <filespec> <address>
  816.   Send the file as electronic mail to the address (if the remote Kermit
  817.   supports this feature).
  818.  
  819. * Getting Information About File Transfer:
  820.  
  821. SHOW STATISTICS
  822.   Display efficiency and other statistics about file transfers.
  823.  
  824. SHOW PROTOCOL
  825.   Display file transfer protocol-related parameter settings.
  826.  
  827. SHOW FILE
  828.   Display file-related parameter settings
  829.  
  830. SHOW SERVER
  831.   Examine server-related parameters
  832.  
  833. * Commands for Talking to a Server:
  834.  
  835. BYE
  836.   Shut down a remote Kermit server and log out its job
  837.  
  838. FINISH
  839.   Shut down a remote Kermit server, put it back at command level
  840.  
  841. GET <remote-filename>
  842.   Ask a Kermit server to send the specified file(s)
  843.  
  844. SEND <filename> [<alternate-name>]
  845.   Send files to remote Kermit receiver or server
  846.  
  847. REMOTE CD [<directory> [<password>]]
  848.   Tell remote server to change to named directory.
  849.  
  850. REMOTE DELETE <filespec>
  851.   Tell remote server to delete the specified files.
  852.  
  853. REMOTE DIRECTORY [<filespec>]
  854.   Tell remote server to send directory listing for specified files.
  855.  
  856. REMOTE HELP
  857.   Ask the server to list the services it provides
  858.  
  859. REMOTE HOST [command]
  860.   Command for remote host in its own command language
  861.  
  862. REMOTE KERMIT [command]
  863.   Send a command to remote Kermit server in its own command language
  864.  
  865. REMOTE LOGIN user
  866.   Login to a remote Kermit server, separate prompts for password, etc.
  867.  
  868. REMOTE MESSAGE text
  869.   Send a one-line message to the remote Kermit server
  870.  
  871. REMOTE PRINT <filespec> [ <options> ]
  872.   Send the file to a remote server and ask the server to print it with the
  873.   specified options, if any.
  874.  
  875. REMOTE SET <parameter> <value>
  876.   Tell remote server to set the specified parameter to the specified value.
  877.  
  878. REMOTE SPACE [directory]
  879.   Show disk space on remote host
  880.  
  881. REMOTE TYPE filespec
  882.   Display remote file(s)
  883.  
  884. REMOTE WHO
  885.   Display users logged on remote system
  886.  
  887. * Commands for Acting as a Server:
  888.  
  889. DISABLE <parameter>
  890.   Disable various capabilities of the server (DISABLE ? for list)
  891.  
  892. ENABLE <parameter>
  893.   Enable various capabilities of the server (ENABLE ? for list)
  894.  
  895. SET SERVER TIMEOUT <num>
  896.   How often the server should send NAK packets while waiting for a command,
  897.   0 = never.
  898.  
  899. SET SERVER LOGIN <name> <password>
  900.   Set up a name and password which must be sent to the server (by REMOTE
  901.   LOGIN) before it will accept any other commands.
  902.  
  903. SERVER [{<seconds>, <hh:mm:ss>}]
  904.   Act as a Kermit server, optionally for or until the given time.
  905.   Default time is forever (until BYE or FINISH received, or interrupted
  906.   with Ctrl-C).
  907.  
  908. The MS-DOS Kermit server honors the following requests:
  909.  
  910. SEND        REMOTE CWD        REMOTE PRINT
  911. GET         REMOTE DELETE     REMOTE MESSAGE
  912. FINISH      REMOTE DIRECTORY  REMOTE SPACE
  913. BYE         REMOTE HOST       REMOTE TYPE
  914. LOGOUT      REMOTE KERMIT     REMOTE SET
  915.  
  916. * Interruption Commands While a File Transfer Is in Progress:
  917.  
  918. X or Ctrl-X: Stop sending the current file and go on to the next one, if any.
  919. Z or Ctrl-Z: Stop sending this file, and don't send any further files.
  920. E or Ctrl-E: Send Error packet to the remote Kermit.
  921. C or Ctrl-C: Return to Kermit command level immediately.
  922. Q or Ctrl-Q: Send a Ctrl-Q (Xon).
  923. Enter key:   Try to wake up a stuck file transfer.
  924.  
  925. * Setting Nonstandard File Transfer Parameters:
  926.  
  927. SET ATTRIBUTES { ON, OFF } = ON
  928.   Enable/Disable processing of file attribute packets.
  929.  
  930. SET ATTRIBUTES { DATE, LENGTH, TYPE, CHARACTER-SET } { ON, OFF } = ON
  931.   Enable/Disable processing of specific file attributes.
  932.  
  933. SET BLOCK-CHECK { 1, 2, 3 } = 1
  934.   Level of error checking, 1 by default, 3 is strongest.
  935.  
  936. SET DEBUG PACKETS
  937.   Display packets on screen during file transfer.
  938.  
  939. SET DEBUG OFF
  940.   Turn off display of packets.
  941.  
  942. SET DESTINATION { DISK, PRINTER, SCREEN } = DISK
  943.   Direct incoming files to the specified device.
  944.  
  945. SET DISPLAY { QUIET, REGULAR, SERIAL } = REGULAR
  946.   Synonym for SET FILE DISPLAY
  947.  
  948. SET FILE DISPLAY { SERIAL, REGULAR, QUIET }
  949.   Format of MS-DOS Kermit's file transfer display.  Use SERIAL for hardcopy
  950.   terminals, braille devices, speaking devices, etc.  QUIET means no display
  951.   at all (used automatically in remote mode).
  952.  
  953. SET EOF { CTRL-Z, NOCTRL-Z } = NOCTRL-Z
  954.   Whether Ctrl-Z marks the end of a PC DOS text file.
  955.  
  956. SET FILE TYPE { TEXT, BINARY } = TEXT
  957.   Text implies record format conversion and character set translation.  Use
  958.   BINARY to send or receive files with no conversaion at all.
  959.  
  960. SET FILE COLLISION { DISCARD, OVERWRITE, RENAME }
  961.   What to do when a file arrives that has the same name as an existing file.
  962.   RENAME = Automatically give the arriving file a unique name.
  963.   OVERWIRE = Overwrite the existing file with the new file.
  964.   DISCARD = Reject any file that has the same name as an existing file.
  965.  
  966. SET FILE CHARACTER-SET { CP437, CP850, CP860, CP863, CP865, CP866 }
  967.   Tell Kermit which IBM PC code page to use when sending or receiving a
  968.   text file.  Default is your current PC code page.  Kermit translates between
  969.   the current file character set and the transfer character set during file
  970.   transfer.
  971.  
  972. SET TRANSFER CHARACTER-SET { TRANSPARENT, LATIN1, CYRILLIC } = TRANSPARENT
  973.   Tell Kermit which character set to use when sending and receiving Kermit
  974.   packets.  TRANSPARENT means no translation.  LATIN1 is ISO Latin Alphabet 1,
  975.   useful for transferring text that contains accented characters with other
  976.   Kermit programs that support this feature.  CYRILLIC is ISO 8859-5 Latin/
  977.   Cyrillic, and can be used only with file character-set CP866.
  978.  
  979. SET UNKNOWN-CHARACTER-SET { DISCARD, KEEP }
  980.   What to do when a file arrives that has an unknown character set.
  981.  
  982. SET FILE WARNING { ON, OFF, NO-SUPERSEDE } = ON
  983.   Obsolete synomym for SET FILE COLLISION
  984.  
  985. SET INCOMPLETE { KEEP, DISCARD } = DISCARD
  986.   What to do with a file that does not arrive completely.
  987.  
  988. SET RETRY <number> = 5
  989.   How many times to retry a particular packet before giving up on the file.
  990.  
  991. SET TIMER { ON, OFF } = ON
  992.   Enable/Disable timeouts and retransmissions during file transfer.
  993.  
  994. SET WINDOW <num> = 1
  995.   Number of sliding window packet slots.  Sizes greater than 1 can be used
  996.   only with other Kermit programs that supports sliding windows.  Improves
  997.   transmission efficiency on long-delay connections.
  998.  
  999. SET SEND (or RECEIVE) <parameter> <value>
  1000.   START-OF-PACKET <num> = 1  packet begin character, normally Ctrl-A
  1001.   END-OF-PACKET <num> = 13   packet end character, normally carriage return
  1002.   PACKET-LENGTH <num> = 94   packet length; 2000 max; > 94 is "long packets"
  1003.   PAUSE <num> = 0            Interpacket pause, milliseconds
  1004.   TIMEOUT <num> = 5          Timeout interval waiting for a packet, seconds
  1005.   PADDING <num> = 0          How many padding characters before each packet
  1006.   PADCHAR <num> = 0          Padding character to use
  1007.   DOUBLE-CHAR <num>          Double packet character <char> when sending.
  1008.   IGNORE-CHAR <num>          Discard <char> from packets when receiving.
  1009.  
  1010. Use SHOW FILE, SHOW PROTOCOL to examine current file transfer settings.
  1011.  
  1012. * Commands for Unguarded File Transfer:
  1013.  
  1014. Kermit can also transfer files or other information with remote computers,
  1015. services, or devices that do not support the Kermit file transfer protocol.
  1016. These methods provide no error detection or correction.
  1017.  
  1018. TRANSMIT <filename>
  1019.   Send a text file to the host as if you were typing it at the keyboard
  1020.   a line at a time.  Waits for linefeed (\10) to echo before sending next
  1021.   line.  Uses all current communication settings (parity, flow, etc).
  1022.   Does not translate character sets.  CRLF is sent as CR only unless SET
  1023.   TRANSMIT LINE-FEEDS ON.  Empty lines are sent as pairs of CRs (or CRLFS)
  1024.   unless SET TRANSMIT FILL is used.
  1025.  
  1026. SET TRANSMIT <parameter> <value>
  1027.   Various parameters used to control TRANSMIT command.
  1028.   FILL-EMPTY-LINE { NONE, SPACE, <char> }
  1029.   LINE-FEEDS-SENT { ON, OFF }
  1030.   PROMPT <char> - character to wait for before sending next line (= \10)
  1031.  
  1032. LOG SESSION <filename>
  1033.   Capture a remote file, which you must TYPE, into the named file
  1034.   (SESSION.LOG by default).
  1035.  
  1036. * Commands for Recording Things:
  1037.  
  1038. LOG TRANSACTION [<filename>] = TRANSACT.LOG
  1039.   Log file transfer names, times, etc, in given file.
  1040.  
  1041. LOG SESSION [<filename>] = SESSION.LOG
  1042.   Record terminal session in given file.
  1043.  
  1044. LOG PACKETS [<filename>] = PACKET.LOG
  1045.   Record file transfer packets in given file
  1046.  
  1047. WRITE {PACKET, SESSION, TRANSACTION, SCREEN} [<text>]
  1048.   Write the text to the specified log file or to the screen.  Text may contain
  1049.   backslash codes, variables, etc.
  1050.  
  1051. CLOSE {PACKET, SESSION, TRANSACTION, ALL}
  1052.   Close the specified log file and stop logging.
  1053.  
  1054. REPLAY <filespec>
  1055.   Display a session log, running it through the terminal emulator.
  1056.  
  1057. SHOW LOG
  1058.   Display names and status of logging and log files.
  1059.  
  1060. Ctrl-]F (while in Connect mode)
  1061.   Dump current text screen into a file.
  1062.  
  1063. Ctrl-End (while in Connect mode)
  1064.   Dump the current screen (text or graphics) into a file.
  1065.  
  1066. SET DUMP <name>
  1067.   Specify name of screen dump file for text screens (KERMIT.SCN by default).
  1068.   Graphics screens are saved to TEKPLTnn.TIF.
  1069.  
  1070. SET PRINTER <filename or PRN or NUL>
  1071.   Sends CONNECT-mode printer material to the indicated file or device
  1072.   instead of to the standard DOS printer name PRN; this is a "print to
  1073.   disk" option. SHOW LOG displays the current filename (defaults to PRN).
  1074.  
  1075. * Variables:
  1076.  
  1077. \%0 is the name of the currently exuting macro (if any).  \%1 thru \%9 are
  1078. its parameters (arguments).  These variables are created when the macro is
  1079. invoked and destroyed when it terminates.  If a macro invokes another macro,
  1080. a new set of arguments is created and the old set is preserved.  (This is
  1081. a change from 3.01 and earlier, in which macro arguments were global.)
  1082.  
  1083. \%a through \%z are global variables that can be modified or accessed in any
  1084. context.
  1085.  
  1086. \v(xxx) is a built-in variable, where xxx is its name:
  1087.    \v(argc)        macro argument count
  1088.    \v(count)       current value of loop counter (SET COUNT / IF COUNT)
  1089.    \v(date)        current date in country format, e.g. dd-mm-yyyy 08-02-1991
  1090.    \v(ndate)       numeric date yyyymmdd, e.g. 19910208
  1091.    \v(directory)   current disk and directory, e.g. C:\LETTERS
  1092.    \v(errorlevel)  current value of ERRORLEVEL variable (SET ERRORLEVEL)
  1093.    \v(keyboard)    IBM PC keyboard type: 88, 101, or (for LK250) 250.
  1094.    \v(platform)    PC type, e.g. IBM-PC, DEC-RAINBOW
  1095.    \v(program)     Program name, MS-DOS_KERMIT
  1096.    \v(speed)       Current transmission speed (only for COM1..4)
  1097.    \v(status)      0 if previous command succeeded, nonzero if it failed.
  1098.    \v(system)      MS-DOS
  1099.    \v(time)        Current time of day, hh:mm:ss, e.g. 12:30:01
  1100.    \v(version)     Numeric program version, e.g. 310 for version 3.10.
  1101.  
  1102. \$(xxx) is a DOS environment variable, e.g. \$(COMSPEC).
  1103.  
  1104. * Macros
  1105.  
  1106. DEFINE <name> [<value>]
  1107.   Defines a macro called "<name>" to have the given value.  If <value> omitted,
  1108.   undefines the name.  Value may be a list of MS-DOS Kermit commands,
  1109.   separated by commas.  Can also be used to define a variable like \%1,\%a,etc.
  1110.   Definition is copied literally (variable names rather than their values).
  1111.  
  1112. [DO] <name> [<parameter1> [<parameter2> [<parameter3> [...]]]]
  1113.   Executes the macro called "<name>", and assigns the parameters, if any,
  1114.   to the variables \%1, \%2, \%3, etc, and sets the variable ARGC to the
  1115.   number of parameters plus one (1 = no parameters, 2 = 1 parameter, etc).
  1116.   These variables are available only within the macro.
  1117.  
  1118. ASSIGN <variable1> <variable2>
  1119.   Copies the current value of <variable2> into <variable1>.  Can also be used
  1120.   for macros.  The definition is evaluated before it is assigned.
  1121.  
  1122. SHOW MACRO [<name>]
  1123.   Shows the definition of the specified macro or variable.
  1124.  
  1125. IF DEFINED <name> <command>
  1126.   Executes the <command> if the <name> is defined.
  1127. IF = ARGC <num> <command>
  1128.   Executes <command> if ARGC is equal to <num> (numeric constant or variable)
  1129. IF < ARGC <num> <command>
  1130.   Executes <command> if ARGC is less than <num>
  1131. IF > ARGC <num> <command>
  1132.   Executes <command> if ARGC greater than <num>
  1133. IF NOT > ARGC <num> <command>
  1134.   Executes <command> if ARGC less than or equal to <num>
  1135.  
  1136. IF =, <, >
  1137.   Can also be used with any numeric variable, not just ARGC, including the
  1138.   other predefined numeric variables, VERSION, COUNT, and ERRORLEVEL, or
  1139.   any other variable (such as \%1, \%a) that has a numeric value.  Use
  1140.   IF EQUAL to compare character strings (see below).
  1141.  
  1142. * Script commands:
  1143.  
  1144. These commands are used (in conjunction with other Kermit commands) for
  1145. carrying out an automated dialog with a remote computer.
  1146.  
  1147. ASK <variable> <prompt>
  1148.   Print the <prompt> on the screen, assign what user types to the <variable>.
  1149.  
  1150. ASKQ <variable> <prompt>
  1151.   Like ASK, but do not echo what user types.
  1152.  
  1153. INPUT [<timeout>] <string>
  1154.   Wait up to <timeout> secs for <string> to arrive at communications port.
  1155.   If it arrives, set SUCCESS.  If not, time out and set FAILURE.
  1156.   String may contain backslash codes.
  1157.  
  1158. OUTPUT <string>
  1159.   Send the <string> out the communications port.
  1160.  
  1161. SET INPUT CASE { IGNORE, OBSERVE } = IGNORE
  1162.   Say whether alphabet case should matter in searching for INPUT string.
  1163.  
  1164. SET INPUT DEFAULT-TIMEOUT <secs> = 1
  1165.   Timeout interval to use if none given in INPUT command.
  1166.  
  1167. SET INPUT ECHO { ON, OFF } = ON
  1168.   Whether to display characters read by INPUT command on the screen.
  1169.  
  1170. SET INPUT TIMEOUT-ACTION { PROCEED, QUIT } = PROCEED
  1171.   PROCEED means set SUCCESS or FAILURE and go on to next statement in macro
  1172.   definition or TAKE file.  QUIT means to quit from current macro or TAKE
  1173.   file immediately upon timeout (i.e. upon failure).
  1174.  
  1175. IF SUCCESS <command>
  1176.   Execute the <command> if the preceding INPUT command succeeded.  Also works
  1177.   with file transfer commands like SEND, RECEIVE, GET, BYE, etc.
  1178.  
  1179. IF FAILURE <command>
  1180.   Execute the <command> if the preceding INPUT or file transfer command failed.
  1181.  
  1182. PAUSE <secs>
  1183.   Do nothing for specified number of seconds, or until any character is typed
  1184.   at the keyboard.  Raises DTR.
  1185.  
  1186. WAIT [<timeout>] [DTR] [CD] [CTS]
  1187.   Wait <timeout> (seconds or until time hh:mm:ss) for specified modem signals.
  1188.   Raises DTR.
  1189.  
  1190. CLEAR
  1191.   Clear communications port input buffer.
  1192.  
  1193. STOP
  1194.   Return from macro or TAKE file to the MS-Kermit> prompt.
  1195.  
  1196. POP
  1197.   Return from current macro or TAKE file to the macro, TAKE file which
  1198.   invoked it, or if none, to the MS-Kermit> prompt.
  1199.  
  1200. GOTO <label>
  1201.   Instead of executing the next statement in the current macro definition or
  1202.   TAKE-file, go to the specified label and begin executing there.  The label
  1203.   must be a word that begins with a colon (:) in the left margin in the
  1204.   current macro definition or TAKE file.
  1205.  
  1206. :LOOP
  1207.   The previous line shows a label called "loop".  GOTO LOOP would find it.
  1208.  
  1209. REINPUT [<timeout>] <string>
  1210.   Like INPUT, but instead of waiting for <string> to arrive at communications
  1211.   port, REINPUT rescans the text that has already arrived.
  1212.  
  1213. SET COUNT <number>
  1214.   Sets the loop counter to <number>.
  1215.  
  1216. IF COUNT <command>
  1217.   Subtract one from count.  If result is greater than 0, execute <command>.
  1218.   Use with GOTO to construct counted loops.
  1219.  
  1220. SET ALARM <time>
  1221.   Set an alarm <time> seconds from now, or at time hh:mm:ss.
  1222.  
  1223. IF ALARM <command>
  1224.   If the alarm time has passed, execute the <command>.
  1225.  
  1226. SET ERRORLEVEL <number>
  1227.   Set errorlevel to be returned to DOS by Kermit upon exit.
  1228.  
  1229. IF ERRORLEVEL <number> <command>
  1230.   If errorlevel of most recently executed DOS command matches or exceeds
  1231.   <number>, execute the <command>.
  1232.  
  1233. IF EXIST <filename> <command>
  1234.   If the named file exists, execute the <command>.
  1235.  
  1236. IF EQUAL <word1> <word2> <command>
  1237.   Execute the command if the two words are the same.  The words may be
  1238.   text or variables.
  1239.  
  1240. IF LGT <word1> <word2> <command>
  1241. IF LLT <word1> <word2> <command>
  1242.   Execute the command if <word1> is lexically greater than (LGT) or lexically
  1243.   less than (LLT) <word2>.  EQUAL, LGT, and LLT are alphabetical comparisons.
  1244.   Case is observed or ignored according to SET INPUT CASE.
  1245.  
  1246. (End of MS-DOS Kermit Help File)
  1247.  
  1248.  
  1249.